home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 003 / motorola / ReadMe < prev   
Text File  |  1993-07-18  |  6KB  |  120 lines
  1. This is the README file for !asm11 and !asm05, the Motorola freeware
  2. assembler for RISC OS. I hope you will like it. Some features are not
  3. documented/unknown. Please read the manual before you start it (I'm sure you
  4. will not...shame on you!) Read at least the following information:
  5.  
  6. This is the user's reference manual for the Archimedes  hosted  Motorola
  7. Freeware  8  bit  cross  assemblers, ported to the Archimedes to take
  8. advantage of the RISC OS facilities, especially throwback, drop and drag,
  9. and multitasking. 
  10.  
  11. It has become much more friendly than the original, command line, PC
  12. version. The code is based upon the Motorola freeware release TER_2.0 v
  13. 2.09. 
  14.  
  15. It's has been largely rewritten in ANSI style, and all the UNIX filing
  16. system calls have been replaced by ANSI ones. It's 99.9 percent compatible
  17. with Motorola ASxx source formats, the small difference regarding the way it
  18. treates the FCC directive (the original was a possible source of bugs, and
  19. buggy too!). 
  20.  
  21. All the RISC OS interface is handled by the appropriate DDE_Utils and
  22. FrontEnd modules: as they are NOT freeware, I cannot supply them. They are
  23. rather common, though, and yes, !asm11/05 run from command line too! 
  24.  
  25. Up to now, I have not had time to study the behaviour of directives at
  26. chapters 4.13, 4.14, 4.15. 
  27.  
  28. The only supported micros are the ubiquitous 68HC11 and 68HC05.  68hc11
  29. generated code has been checked vs a large collection of files, 68hc05 only
  30. a small set.
  31.  
  32. !asm11/05 are freeware. However, as it took many hours to port it, I request
  33. the user to send, in exchange, feedback on its use and reports any bugs, so
  34. that I can get rid of them for everybody's joy! You are not allowed to make
  35. money reselling it as a software product. If you use it professionally and
  36. develop any systems, I'd love to know it. If you think it's valuable, a
  37. donation is welcome (say, 5 or 10ú). Also, does anyone want to make a nice
  38. icon for it?
  39.  
  40. The manual is in a very preliminary stage. I couldn't cross check it 100%
  41. versus the real assembler behaviour, but should give you enough info to
  42. start working. It comes in three forms: an Impression file, a Postscript
  43. file (if you don't have Impression but have access to a PS printer) and an
  44. ASCII (saved from Impression) plain text (unformatted), for the rest of the
  45. world. The more discrepancies you'll report between it and !asm11/05, the
  46. better it will become. Thanks. 
  47.  
  48. You can redistribute this software, according to the following terms: 
  49.  
  50. a) This program is distributed in its entirety, included copyright messages
  51. and these conditions, and in original and unaltered copies. This is only
  52. because I want to keep track of it and check any alterations, and be
  53. reasonably sure that nobody blames me for someone else's fault. Also, as I
  54. said for the manual, bugs will probably be fixed and it's for everybody's
  55. good to have it done. 
  56.  
  57. b) No charge is taken for such distribution.  
  58.  
  59. c) You don't flame me for coding style: I don't like it either, it's
  60. difficult to mantain, it was not ANSI, but I'm very grateful to the guy who
  61. took the time to write it in the beginning. I do it in my spare time, my
  62. goal was to have it run asap, and it's free! 
  63.  
  64. Legally, you are not bound to this agreement, but failing to do so will make
  65. your conscience haunt you for the rest of your life!  
  66.  
  67. Neither Motorola, Inc. (obviously, as they don't even know this assembler
  68. exist, yet! I will upload it to their BBS anyway) nor Maurizio Ferrari makes
  69. any warranty, expressed or implied, with regard to this material including
  70. but not limited to merchantability and fitness for a given purpose. The
  71. information in this document is subject to change without notice and neither
  72. Motorola, Inc. or Maurizio Ferrari assumes any responsibility for any errors
  73. which may appear herein. Nor shall Motorola, Inc. or Maurizio Ferrari bear
  74. any liability for use of this material with respect compensatory, special,
  75. incidental, consequential, or exemplary damages. 
  76.  
  77. This software may contain bugs, and these in turn may cause any disaster you
  78. can think of, including but not limited to your wife/girlfriend
  79. husband/boyfriend /anyone hitting you hard for staying awake at night
  80. debugging nasty code. You have been warned - I know what it's like.
  81. If this is a problem, you may resort to a commercial product. 
  82.  
  83. The manual  details  the  features and capabilities  of  the  cross  
  84. assemblers,   assembler   syntax   and directives,  options,  and  listings. 
  85. It  is  intended as a detailed reference and an introduction  for  those 
  86. unfamiliar  with  Motorola assembler   syntax  and  format.   READ it! 
  87.  
  88. Many thanks to my lovely wife Olivia for not hitting me, thus allowing this
  89. program to be distributed.
  90. ----------------------------------------------------------------------------
  91.  
  92. Getting Started  I have included the source code to MCX1.5 , an HC11
  93. freeware excellent kernel. Double click the !as11 Icon, drag the SYSTEM fiel
  94. on the icon bar as11 icon, then drag MCX, CLOCKDRIVER, VECTORS to the pop-up
  95. window (in this order!). Set the desired options and run the assembler. A pc
  96. version of the Motorola assembler is included, as well as a batch file 
  97. (assemble.bat) to compile the MCX1.5 files from DOS command line, so you can
  98. cross check the RISC OS and DOS generated S19 files
  99.  
  100. The MCX15 example directory structure (as11, l, m, s19, x) must be kept for
  101. any project. AS11 and S19 directory can have any name but m, l, x cannot
  102. change. Wimp$ScrapDir must be set.
  103.  
  104.  
  105. root level                       $
  106.                                 /|\
  107.                              .........
  108. proj level          as11   l    m    s19    x
  109.  
  110. Same applies for the only file I can provide for HC05.
  111.  
  112.  
  113. Maurizio Ferrari
  114. Via Pareto 12
  115. 42020 Albinea (RE)
  116. Italy
  117.                                      
  118. e-mail ferrari@bologna.maraut.it
  119.  
  120. My Archimedes is fantastic!